
                                               .o
  .oooooo   oooooo,   ooooooo, oooo, ooo       88,.o8[          .oo,.         
  '888"Y8b, Y88P"88o  Y88P"88[ Y88P`'Y8"  d[   88 '88[         d88"88[        
   ]8[  ]8b  88   88, .88 .,Y8 ]88   ]P .d8bo   o  88`   ooo  d8P  '8[  o, .o,
   88`  ]88 ]8P   88[ ]8[ 8` " ]88   d[ ]8888]88[  88  .88"88.88`   ]bd88[ d8`
   88   ]88 ]8[   88[ ]8888    ]8[   8[  88  'Y8[  88  88b,'"]88       88  88 
   88   ]8P ]8[   88` 88['8    88[   8   88   ]8[ ]8P  ]888b,]88       88  88 
  ]8P   88` 88`  ]8P  88  " dP 88[  .8  ]8P   88` ]8[   '"888]88    .o.8P .8P 
  d8[ .d8P .88  o88` .88, od8` 88b .dP  ]8bo[ 88,,]8[ ]8, d8P 88o  o8`]8bod8[ 
 8888888" ]888888P` ]8888888P  '8888"   ]88P` Y88`]88P'Y888P  'Y888P` '888Y8[ 
                                                   '                  o,  88  
                                                                     '88o88`  
                                                                      '"""`   

                DDEUtils replacement module
                For RISC OS v3.10 or later

                Copyright (C) Cy Booker 1993-1995


   Purpose:

       The module DDEUtilsCy and the obey file InitDDECy are intended
       to provide the functionality of Acorns' DDEUtils module, but
       supplied free of charge (freeware).  The author retains
       copyright.

          This package is supplied "as is".  No warranty, express
          or implied, of the  merchantability of this program or its
          fitness for any particular purpose is given.  In no
          circumstances shall the author, or any provider or
          distributor of this program, be liable for any damage, loss
          of profits, or any indirect or consequential loss arising
          out of the use of this program.
    
       The DDEUtils module implements throwback, long command lines,
       and supports separate tasks having their own currently selected
       (disc) directory.
       
       The DDEUtilsCy replacement does not support the CSD part of the
       original module, but does support the API.


   Quick use:

       Double-click on the InitDDECy obey file, then double-click the
       DDEUtilsCy module.


   To use permenantly:

       1. Copy the DDEUtilsCy module into System:Modules
       2. Copy the InitDDECy obey file into System:Modules
       3. Copy the IfExist utility to you Run$Path ($.Library)

       Then in your 'load' do something like this in an Obey file:

           RMEnsure DDEutils 0.02 IfExist System:Modules.DDEUtils Then RMLoad System:Modules.DDEUtils
           RMEnsure DDEUtils 0.01 %Obey -c System:Modules.InitDDECy
           RMEnsure DDEUtils 0.01 RMRun System:Modules.DDEUtilsCy

       The DDEUtilsCy module has a version number of 0.01, so ensuring
       that if you do have a legitimate copy of DDEUtils, it will
       always be used.

       Note the need for the IfExist clause, otherwise if the user
       does not have a DDEUtils module then this would generate an
       error (missing file).

       For RISC OS 3.50 and later you may replace IfExist with
       IfThere, a utility that comes supplied with the computer.


   To use in a distribution:

       Place the DDEUtilsCy into a private directory, rename it
       to DDEUtils, and set up a system variable such as:

          Set App$Path <System$Path>,<App$Dir>.
          RMEnsure DDEUtils 0.02 %Obey -c App:InitDDECy
          RMEnsure DDEUtils 0.02 RMRun App:DDEUtils

       Note that System$Path comes before anything else.


   Support:

       For source code/support please email
       ddeutils@cheepnis.demon.co.uk, or send a sae to:

                Mr. Cy J. Booker
                86 Church View, Main Road
                Crockenhill, Swanley
                Kent.  BR8 8JW
                UK


   History:
   
       v1.00       1993.10.28 first version
       v2.00       1993.11.04 full throwback support
       v3.00       1994.09.11 CLI support
       v4.00       1994.12.04 Prefix API support
       v5.00       1995.02.03 changed version to 0.01, docs
       v5.01       1995.06.29 *Set Prefix$Dir sets CSD
